#!/usr/bin/python
# -*- coding:utf-8 -*-
# 第 49 条: 为每个函数、类和模块编写文档字符串

# 我们应该通过 docstring，为每个模块、类和函数编写文档。在修改代码的时候，应该更新这些文档
# 为模块撰写文档时，应该介绍本模块的内容，并且要把用户应该了解的重要类及重要函数列出来
# 为类撰写文档时，应该在 class 语句下面的 docstring 中，介绍本类的行为、重要属性，以及本类的子类应该实现的行为
# 为函数及方法撰写文档时，应该在 def 语句下面的 docstring 中，介绍函数的每个函数，函数的返回值，
#   函数在执行过程中可能抛出的异常，以及其他行为











